home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-2.iso / bbs / twast23.zip / TWASTMAC.DOC < prev    next >
Text File  |  1995-12-02  |  39KB  |  1,140 lines

  1.  
  2.                         ▄                             ▄
  3.          ▀▀█▀▀  █▀▀▄  █▀▀▀█  █▀▀▄  █▀▀▀  █▄     ▄█  █▀▀▀█  █▀▀▄  █▀▀▀
  4.            █    █▄▄▀  █▄▄▄█  █  █  █▀▀    █ ▄█▄ █   █▄▄▄█  █▄▄▀  ▀▀▀█
  5.            █    █  █ ▄█   █▄ █▄▄▀  █▄▄▄   █▄█ █▄█  ▄█   █▄ █  █  ▄▄▄█
  6.       ▄                                               ▄
  7.    ███████  ███████  ███████  ██  ███████  ██████  ███████  ██    ██  ██████
  8.    ██   ██  ██       ██       ██  ██         ██    ██   ██  ███▄  ██    ██
  9.    ███████  ███████  ███████  ██  ███████    ██    ███████  ██▀██▄██    ██
  10.    ██   ██       ██       ██  ██       ██    ██    ██   ██  ██  ▀███    ██
  11.   ███   ███ ███████  ███████  ██  ███████    ██   ███   ███ ██    ██    ██
  12.                                ▄
  13.                    █▀█ █▀█   █▀▀▀█   █▀▀█  █▀▀▄  █▀▀█  █▀▀▀
  14.                    █ ▀█▀ █   █▄▄▄█   █     █▄▄▀  █  █  ▀▀▀█
  15.                   █▀     ▀█ ▄█   █▄  █▄▄█  █  █  █▄▄█  ▄▄▄█
  16.  
  17.  
  18.                                  Version 2.3
  19.  
  20.                                 for use with
  21.                           Trade Wars 2002 Assistant
  22.                              contributed by many
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62. ╔════════════════════════════════════════════════════════════════════════════╗
  63. ║                             Table of Contents                              ║
  64. ╚════════════════════════════════════════════════════════════════════════════╝
  65.  
  66.  
  67.   1   Introduction  . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  68.  
  69.        1.1   Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . .   3
  70.  
  71.  
  72.   2    General Information  . . . . . . . . . . . . . . . . . . . . . . .   4
  73.  
  74.        2.1   Universe mappers . . . . . . . . . . . . . . . . . . . . . .   4
  75.  
  76.  
  77.   3    Qmodem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
  78.  
  79.  
  80.   4    Telix  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  81.  
  82.  
  83.   5    Procomm Plus . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
  84.  
  85.  
  86.   6    Commo  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
  87.  
  88.  
  89.   7    Telemate . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
  90.  
  91.  
  92.   8    Procomm Plus for Windows . . . . . . . . . . . . . . . . . . . . .  19
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.                                    Page 2
  120.  
  121.  
  122. ╔════════════════════════════════════════════════════════════════════════════╗
  123. ║ Section  1                    Introduction                                 ║
  124. ╚════════════════════════════════════════════════════════════════════════════╝
  125.  
  126.     People have contributed these macros to help users capture the reports
  127.   during a Trade Wars session.  You are not required to use them.  You may
  128.   capture the information in the manner that best suits you.  The macros are
  129.   a bonus and are not considered part of the TWASSIST software.
  130.  
  131.     These macros are provided as freeware.  You may modify them for your own
  132.   use.  You may distribute modified macros as a separate package but you may
  133.   not distribute modified macros as part of any TWASSIST package.
  134.  
  135.  
  136. ░▒▓█  1.1  █▓▒░  Disclaimer
  137.  
  138.     The macros are provided AS IS.  Neither Sasquatch Software nor the macro
  139.   authors provide any warranty, either expressed or implied, with respect to
  140.   the software or documentation, including but not limited to their quality,
  141.   performance, merchantability, or fitness for a particular purpose.  In no
  142.   event will Sasquatch Software or the author be liable for direct, indirect,
  143.   special, incidental, or consequential damages arising out of the use,
  144.   misuse, or inability to use the software or documentation, even if advised
  145.   of the possibility of such damages.
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.                                    Page 3
  180.  
  181.  
  182. ╔════════════════════════════════════════════════════════════════════════════╗
  183. ║ Section  2                 General Information                             ║
  184. ╚════════════════════════════════════════════════════════════════════════════╝
  185.  
  186.  
  187.     The section title is the name of the communications program the macro is
  188.   for.  Each section will include the name of the macro file, the author of
  189.   the macro, and information on how to use the macro.  All of the macros are
  190.   in the TWASTMAC.ZIP file.  Find the macro file you want to use, as named in
  191.   the section for your communications program, and extract it from the file.
  192.  
  193.     Typically the macros were developed to be executed from the main Trade
  194.   Wars menu.  Each section will identify any special requirements.
  195.  
  196.   WARNING:  These macros will invoke computer interrogation mode in the game
  197.             and do a port report.  There is a bug in v1.03 of Trade Wars 2002
  198.             where it will kick you out of the game if you have not ported or
  199.             statused a port before doing this.  To prevent this, either port
  200.             or get a port status from the computer.  You can do this with
  201.             any port except a class 0.
  202.  
  203.   
  204. ░▒▓█  2.1  █▓▒░  Universe mappers
  205.  
  206.     The macros have a feature to map the structure of the TW universe using
  207.   route commands prepared by TWASSIST.  They run TWASSIST to prepare the file
  208.   of route commands to be sent to the CIM prompt in the game.  The macro
  209.   reads the route commands from the file and sends them to the game while
  210.   pacing with the game's prompts and capturing the data from the game.  It
  211.   then runs TWASSIST to read the capture file and prepare another list of
  212.   route commands.  Repeat the sequence to gather more data on the warps in
  213.   the universe.  If you don't have enough time to get all the data at once
  214.   do it a little each day.  See the section on Map universe routes in the
  215.   TWASSIST doc for more information.
  216.  
  217.     The universe mapper macros should run smoothly and continuously but they
  218.   are very dependent on text and prompts from the game to properly pace the
  219.   inputs to the game.  If the macro does not see the text it is looking for
  220.   or gets something unexpected (e.g. line noise, unanticipated situations,
  221.   changes to text by TW2002 v2.0, etc.) it may hang.  If that happens then
  222.   take a guess at what the response to the games prompt should be and enter
  223.   it yourself.  The macro may be able to pick it up from there.
  224.  
  225.     The most troublesome part of creating a macro for the universe mapper
  226.   is turning off ANSI in the game.  Different versions of the game have
  227.   different ways of changing the ANSI status.  It is not required to have
  228.   ANSI off for the mapper to work but it does improve performance.  The ANSI
  229.   data about doubles the amount of data in a route transferred over the modem
  230.   eventhough you don't see it yourself.  With high speed modems the time for
  231.   the game to calculate the routes and for running TWASSIST are a bigger
  232.   factor.  Still ANSI can increase the overall time by 25%.  For low speed
  233.   modems the data transfer becomes a more important factor.  At 2400 baud it
  234.   takes about twice as long to map the universe.  With ANSI on that time can
  235.   be increased about 50% over running with ANSI off.  If you have problems
  236.   with the ANSI section of the macro try commenting that portion of the macro
  237.   out.  You can manually turn ANSI off prior to running the mapper to get the
  238.   better performance.
  239.                                    Page 4
  240.  
  241.  
  242. ╔════════════════════════════════════════════════════════════════════════════╗
  243. ║ Section  3                       Qmodem                                    ║
  244. ╚════════════════════════════════════════════════════════════════════════════╝
  245.  
  246.   File:  TWASSIST.SCR
  247.     By:  Albin Gersich
  248.   Date:  11/24/95
  249.  
  250.     Gathering all the data that TWASSIST can use is as simple as pressing a
  251.   key with this script.  You can use it as is or customize it for your own
  252.   use.  There are a few variables at the top of the script that may need to
  253.   be modified for your configuration.
  254.  
  255.     This script provides a menu of options, allowing you to capture all the
  256.   reports used by TWASSIST or just some of them.  Maybe you don't have much
  257.   time left and you only want to get the CIM reports, or you have just started
  258.   your session and want to get updates on fighter and mine deployment.  Here
  259.   is the menu:
  260.  
  261.         (T)W2002 Assistant
  262.  
  263.         (A)ll reports
  264.         (C)IM sector and port reports
  265.         (P)ort report
  266.         (F)ighters, mines, and avoids
  267.  
  268.         (M)ap universe routes
  269.  
  270.         E(x)it script
  271.  
  272.         Your selection?
  273.  
  274.  
  275.     The option that runs TWASSIST has two variables that may need changing
  276.   depending on where files are located on your system.  One variable specifies
  277.   the location of the TWASSIST executable, the default is c:\tw\twassist.exe.
  278.   The other variable is the directory where your data files are stored, the
  279.   default is c:\tw.  This directory variable is used to change your current
  280.   directory to that location before running TWASSIST allowing you to enter
  281.   your database name without the full path.
  282.  
  283.   Example key assignment (CTRL-F10 for example):
  284.     - Press ALT-J in QModem
  285.     - Press '3' to assign a CTRL key
  286.     - Move cursor to key field (example:  CTRL-F10 field)
  287.     - Type @SCRIPT TWASSIST
  288.     - Press F10 to save
  289.     - Press ESC to exit
  290.  
  291.   QModem Usage:
  292.     - Start your screen capture by pressing CTRL-HOME
  293.     - Make sure you are at the main command prompt in Trade Wars.
  294.     - Execute the TWASSIST.SCR file by pressing the key assigned to it.
  295.     - Select the macro option from the menu shown.
  296.     - When your screen stops you can press CTRL-HOME to close the screen
  297.       capture.
  298.  
  299.                                    Page 5
  300.  
  301.  
  302. ╔════════════════════════════════════════════════════════════════════════════╗
  303. ║ Section  4                       Telix                                     ║
  304. ╚════════════════════════════════════════════════════════════════════════════╝
  305.  
  306.   File:  TWASSIST.SLT
  307.   File:  TWA_MAP.SLT
  308.     By:  Phil Crown
  309.   Date:  07/17/94  v1.4
  310.  
  311.     Gathering all the data that TWASSIST can use is as simple as pressing a
  312.   key with this script.  I've included the source code for those who want to
  313.   incorporate this into their own scripts, or you can customize this one.
  314.   You must compile the script as described in the note below before you can
  315.   use them.
  316.  
  317.     The scripts have been updated to support Trade Wars 2002 v2 wide beta
  318.   games.  They should be able to handle v1.03(d) games was well.
  319.     
  320.     This script provides the following menu of options, allowing you to 
  321.   capture all the reports used by TWASSIST or just some of them.  Maybe you 
  322.   don't have much time left and you just want the CIM reports, or you have 
  323.   just started your session and want to get updates on deployed fighters 
  324.   and mines.
  325.                    ╒═ 02/05/93 - D. Roseen - v1.3 ═╕
  326.                    │                               │
  327.                    │ (T)W2002 Assistant            │
  328.                    │                               │
  329.                    │ (A)ll reports                 │
  330.                    │ (C)IM warp and port reports   │
  331.                    │ (P)ort report                 │
  332.                    │ (F)ighters, mines, and avoids │
  333.                    │ (M)apping the universe        │
  334.                    │                               │
  335.                    │ E(x)it script                 │
  336.                    │                               │
  337.                    │ Your selection?               │
  338.                    │                               │
  339.                    ╘═══════════════════════════════╛
  340.     
  341.     *** NOTE! ***  If your TWASSIST directory is not C:\TW you you MUST
  342.   change the default TWASSIST directory in the Telix script source code for 
  343.   proper operation!  This is the directory which contains your TW Assistant
  344.   executable and data files.  You can change it with a simple ASCII text 
  345.   editor and recompile the source code by running Telix's CS.EXE program 
  346.   (e.g. CS TWASSIST) and CS.EXE will create a new TWASSIST.SLC file from your 
  347.   revised TWASSIST.SLT file.  The directory variable is used to change your 
  348.   current directory to that location before running TWASSIST.  This makes it 
  349.   easier to enter the name of the database at the TWASSIST prompt.  You only 
  350.   have to enter the name instead of the full path.
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.                                    Page 6
  360.  
  361.  
  362.                               4  Telix  (cont'd)
  363.  
  364.  
  365.   Example key assignment (CTRL-F10 for example):
  366.     - Press ALT-K in Telix
  367.     - Select default of "Regular" or press 'R'
  368.     - Select "Edit" or press 'E'
  369.     - Press the key you want it assigned to (example:  CTRL-F10)
  370.     - Type @TWASSIST
  371.     - Press the space bar since you don't want to assign any more keys.
  372.     - Select "Save" or press 'S' and save to a key file.
  373.     - Select "Exit" or press 'E'
  374.  
  375.   Telix Usage:
  376.     - Start your screen capture by pressing ALT-L
  377.     - Make sure you are at the main command prompt in Trade Wars.
  378.     - Execute the TWASSIST.SLC file by pressing the key assigned to it.  You
  379.       will see the menu and then make your selection.
  380.     - When your screen stops you can press ALT-L and close the screen capture.
  381.  
  382.  
  383.   Update: The update from 1.2 to 1.3 was done by Stephen Whitis, in
  384.   preparation for the release of TWAssist 2.0.  The TWAssist script runs
  385.   exactly as it did before, with one exception.  There is now a menu
  386.   selection for (M)apping the universe.  When the user chooses that
  387.   command, the TWASISST.SLC script will call another script named
  388.   TWA_MAP.SLC.  That is the script which handles mapping by acting as the
  389.   messenger between TWASSIST and the TW2002 cim mode.
  390.  
  391.   TWA_MAP can also be called directly, by adding a call to it via your key
  392.   file, just as you did with TWASSIST.SLC.
  393.  
  394.   The remainder of these notes apply to TWA_MAP.SLT and .SLC.
  395.  
  396.   ** Note ** These notes only apply if you are using TWA_MAP.SLT in a v1.03x
  397.              game.
  398.  
  399.   If your TWASSIST directory is not C:\TW you you MUST change the default
  400.   TWASSIST directory in the Telix script source code for proper operation!
  401.   This is done by modifying and compiling TWA_MAP.SLT the same way you did
  402.   with TWASSIST.SLT, documented above.
  403.  
  404.   TWA_MAP must be run from the "Command [TL" prompt.  It will not run
  405.   unless you begin at that point.
  406.  
  407.   When TWA_MAP runs, it will ask for a gamename.  This is the name of the
  408.   database TWASSIST is using for your current game.  You can enter a
  409.   leading path if needed, but if you don't, it will use the current
  410.   directory.  (And if you have defined the default directory in TWA_MAP,
  411.   you shouldn't need to enter a leading path at all.)
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.                                    Page 7
  420.  
  421.  
  422.                               4  Telix  (cont'd)
  423.  
  424.  
  425.   TWA_MAP will check to see if a file named <gamename>.DAT exists.  If it
  426.   does, TWA_MAP continues.  If not, TWA_MAP generates a warning.  If you
  427.   should already have a TWASSIST database for this game, you can abort.  If
  428.   you don't, you can continue, and one will be created.
  429.  
  430.   The next prompt will ask for how many warps to plot.  The default is 250
  431.   for 2400 baud modems, 400 for faster modems, and 100 for slower modems.
  432.   Any number from 100-1000 is valid.
  433.  
  434.   After that prompt, everything is automated.  After the warps have been
  435.   plotted and processed, you will be asked if you wish to continue.  If you
  436.   do, it will plot the same number of warps again (using different paths,
  437.   of course.)
  438.  
  439.   When TWA_MAP runs, it will turn ANSI off, and save the original ANSI
  440.   status to restore when it finishes.  It will also close your capture
  441.   file, if you have one open, and save information so it can re-open the
  442.   capture file if needed.  The capture file which TWA_MAP uses will be
  443.   deleted after each call to TWAssist, and will not use your default
  444.   filename.
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.                                    Page 8
  480.  
  481.  
  482. ╔════════════════════════════════════════════════════════════════════════════╗
  483. ║ Section  5                     Procomm Plus                                ║
  484. ╚════════════════════════════════════════════════════════════════════════════╝
  485.  
  486.   File:  ASTV2B.ASP     08/27/94
  487.   File:  PTRADE1.ASP    05/17/94
  488.   File:  SHADOW1.ASP    03/21/93
  489.     By:  Rick Cooney
  490.   Date:  (noted above)
  491.  
  492.  
  493.               ProComm Plus 2.01 script for use with TWAssist
  494.               ----------------------------------------------
  495.                    (thrown together by Rick Cooney)
  496.  
  497.  
  498.     First off, I almost didn't submit these scripts to Albin cause I
  499.   really, really hate writting documentation.  So, if any of what follows
  500.   is unclear....
  501.  
  502.     Second, by running these scripts you accept full responsibility for
  503.   anything that occurs, either real or imagined, that is related to
  504.   running them in even the slightest way.
  505.  
  506.     It's assumed that you are familiar with the way PCPlus uses script
  507.   files so no attempt will be made to explain them.  Read your manual
  508.   if your not up to speed.
  509.  
  510.     I always ran the script from my PCPlus directory since the directory
  511.   is setup to be accessable from any drive or directory.
  512.  
  513.     My TWAssist files were kept in a seperate directory named assist.
  514.  
  515.                       -------------------------------
  516.  
  517.     All scripts run most efficiently with ansi off.  Some have a tendency
  518.   to hang with ansi on.
  519.  
  520.     All filenames that are prompted for should be entered _without_ an
  521.   extension.  I didn't included any code to trap names entered with an
  522.   extension. If you include one the script will more than likely return
  523.   an error.
  524.  
  525.                       -------------------------------
  526.  
  527.     What do the scripts do?
  528.  
  529.     The main script is modeled after the PCPlus scripts written by Jason
  530.   Jiggins that were distributed with TWAssist ver. 1.0.  They have been
  531.   updated to work with both TW2002 versions 103/d and 2.0 beta.  An inter-
  532.   face to the Zero Turn mapping function in TWAssist was added using the
  533.   Telemate and QModem scripts (written by Stephen Whitis and Albin Gersich)
  534.   as a guide.
  535.  
  536.  
  537.  
  538.  
  539.                                    Page 9
  540.  
  541.  
  542.                            5  Procomm Plus  (cont'd)
  543.  
  544.  
  545.     The purpose is to ease the gathering of data used by TWAssist.  The
  546.   script interfaces with TW2002 to create port, sector, fighter, mine,
  547.   and avoid reports either all in one or in seperate files.
  548.  
  549.     An option to run TWAssist from a shell to dos is included but it's
  550.   success is dependent on the availibility of the memory required by
  551.   TWAssist.
  552.  
  553.     The "map universe routes option" interfaces with TWAssist zero turn
  554.   mapping function.
  555.  
  556.  
  557.     The script is menu driven and self explanatory.  You will be prompted
  558.   for any information you need to provide.
  559.  
  560.                       -------------------------------
  561.  
  562.     Setup
  563.  
  564.     Copy the files astv2b.asp and shadow1.asp to your PCPlus Directory or
  565.   where ever you wish to run them from.  It's up to you to decide how they
  566.   will be run.  I have them included in a tradewar.key file that I load when
  567.   I am playing TW.
  568.  
  569.     You must alter the astv2b.asp script to point to the directory that
  570.   your TWAssist files are kept in.  The following is the scetion of the
  571.   script that must be changed.  Load the script into an editor (pcedit.exe
  572.   works well) and find the following section.
  573.  
  574.  
  575.  
  576. ; -----------------------IMPORTANT-----------------------
  577.  
  578. define DataDir "d:\assist"  ; change this to the path to your TW Assist files.
  579.                             ; To avoid having to add the path to every file
  580.                             ; used the script first changes to this dir.
  581.  
  582. ; --------------------------------------------------------
  583.  
  584.  
  585.     Replace the      "d:\assist"      with your own TWAssist directory.
  586.  
  587.     Just as a warning, the mapping funtion writes a temporary file named
  588.   capture.txt to the TWAssist directory when it is run.  Any file in the
  589.   directory with the same name will be deleted.  If that's a problem you'll
  590.   have to search astv2b.asp for "capture.txt" and name it something else.
  591.  
  592.  
  593.                       -------------------------------
  594.   
  595.     Did any of that make sense?
  596.  
  597.  
  598.  
  599.                                    Page 10
  600.  
  601.  
  602.                            5  Procomm Plus  (cont'd)
  603.  
  604.  
  605.     No?  I can be reached in the Fido Tradewars echo or by netmail at
  606.   1:2613/133.  Maybe if you ask a specific question I can give a clear
  607.   answer.
  608.     I've been using these scripts in various forms for a couple of years.
  609.   They work for me.  If they don't work for you, tell me what's happening.
  610.   Maybe I can point you in the right direction.
  611.  
  612.                       -------------------------------
  613.  
  614.     Just for laughs I included a paired port trading script.  If the others
  615.   meet your needs, give this one a try.
  616.  
  617.     It needs to be run from the main TW command line while at one of a
  618.   matched pair of ports.  You'll need a psychic probe and turn ansi off.
  619.   It's not on the menu.  You'll have to set up a seperate meta key to run it.
  620.  
  621.  
  622.  
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.                                    Page 11
  660.  
  661.  
  662. ╔════════════════════════════════════════════════════════════════════════════╗
  663. ║ Section  6                        Commo                                    ║
  664. ╚════════════════════════════════════════════════════════════════════════════╝
  665.  
  666.   File:  TWASSIST.MAC
  667.     By:  Mark Cothran
  668.   Date:  11/20/93
  669.  
  670.     This Macro can only be used from COMMO v5.4. It added a menu system to
  671.   the programming languange and will NOT work with earlier versions.  I wrote
  672.   this using v5.5, but did not include any of the fancy new menuing commands
  673.   that goes with newer versions.
  674.   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  675.  
  676.   WHY:
  677.     Often all you need is just a few updates to your database, not a full
  678.   update, although you sometimes want that too!
  679.  
  680.   HISTORY:
  681.     Three note worthy events: Fred Brucker releases Commo 5.4, Fred Polli
  682.   releses Power Macros for Commo and Albin Gersich releses TW Assistant,
  683.     ...from then own, your competition is history!
  684.  
  685.   INSTALLATION:
  686.     You will need to decide WHICH key to put this macro on. This will depend
  687.   on what macros you already use. At Present, Power Macros (v1.9,v2.5 and,v3)
  688.   does not use Shift F1 key, so you may use that, or the ALT-V as suggested
  689.   in an earlier macro..the choice is yours!
  690.  
  691.   1) Move the TWASSIST.MAC file to the area where the rest of your Commo
  692.      Macro's are.
  693.  
  694.   2) From the Main Terminal Menu, hit ALT-G. You will need to add the
  695.      following line to your configuration file:
  696.  
  697.      {set twasst,C:\terminals\commo\assist}
  698.                  ╙─────────┬─────────────╜
  699.                            │
  700.                            └──< or whereever YOUR Assist directory is!
  701.                                              ~~~~
  702.  
  703.      This is also a good time to make sure your "_hom" variable is set.
  704.      Thats the directory to the Commo root directory. Using the example
  705.      above, it would be "{setv _hom,C:\terminals\commo}"
  706.  
  707.      Completelly exit Commo (ALT-X), and re-boot it for the new config
  708.      to take effect.
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.                                    Page 12
  720.  
  721.  
  722.                               6  Commo  (cont'd)
  723.  
  724.  
  725.   3) From the main terminal prompt, hit ALT-M to call up the macro processor
  726.      menu you will need to ADD (EDIT) the following line to your macro:
  727.  
  728.           ╓────╥───< IF you want the SHIFT F1 Key (see COMMO.DOC)
  729.           ║    ║
  730.           {:sf1}{macl-r twassist.mac,twassist}{}
  731.  
  732.   4)            Power Macro Users - See the note below
  733.      Enter the terminals dialer menu and somewhere add another variable
  734.      called the "pref" variable. This is a name assigned to the variable
  735.      PREF that will allow you to keep the data files seperate for different
  736.      games automatically. I've seen a wide variance in dialer screens for
  737.      Commo, but a generic one is like this:
  738.  
  739.      NAME:          Last Called:    Number:      Password:     Variable:
  740.      Night Owl BBS   11/19/93    {12066314949}    {****}    {pref,nightowl}
  741.  
  742.      It doesn't matter where you put it, as long as it's a unique name for
  743.      each BBS and is in the format {pref,BBSNAME}.
  744.  
  745.      Now, by pressing SHIFT F1 from the terminal, it will load up TWASSIST.MAC
  746.      and give you a menu to do things from. Please consult MACRO.DOC (Commo)
  747.      for more information about changing the ALT-KEY combinations that
  748.      execute the macro.
  749.  
  750.      As long as you don't have any other macro's assigned the SHIFT F1 key,
  751.      you can use that.
  752.  
  753.   5) To return to your normal macros, hit the F10 Key!!!
  754.  
  755.   POWER MACROS NOTE:
  756.     Since the Version 3.0 PWRMAC's that I wrote this from uses 5 seperate
  757.   macros (commo.mac, powermac.mac, other.mac, other1.mac, and user.mac) you
  758.   will need to add line 3 to *ALL* the macros to ensure that you can move from
  759.   one area to another without a problem. Use the Commo editor (ALT-U) and edit
  760.   each macro. (ADD line 3 above to ALL your macros.)
  761.  
  762.   If your already using PREF variables, then you can skip step 4 above.
  763.  
  764.   **** If you aren't using Power Macros, just add the line to COMMO.MAC. ****
  765.  
  766.   CONCLUSION:
  767.     At present, I can be contacted via the RIME Tradewars echoes (which I
  768.   moderate), and occasionally on the FIDO and WWIV Tradewars Conferences.
  769.   Or you can reply to Albin and he can get us together.
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.                                    Page 13
  780.  
  781.  
  782.                               6  Commo  (cont'd)
  783.  
  784.  
  785.   USE TIPS:
  786.   1. The macro MUST be ran from the Main Screen in Tradewars.
  787.   2. I added an option to delete OLD GAME.DAT files, read the prompts!
  788.   3. The NEW mapping routines from TWASSIST v2: This was the real reason
  789.      for an update to the macro. The macro reads a text file generated
  790.      from TWASSIST, opens a capture, then interrogates the remote game.
  791.      If you encounter problems, make sure your twassist variable is included
  792.      in with COMMO.SET file. (See # 2 above!)
  793.   4. If after editing it in and you DON'T get a menu, then re-do # 3 above!
  794.   5. As Albin expands the auto-command language, there may be more updates.
  795.   6. As a default, I have the max routes plotted set to 250. If you decide
  796.      that you want to permantently change the number, then edit the macro
  797.      and change the "maxro" variable to what you want. You do have an option
  798.      to temporarilly change them while online as well.
  799.  
  800.   USER LICENSE:
  801.     Support the Shareware Authors efforts, register THEIR products! This is
  802.   released to the public as freeware, all I ask you do do is register your
  803.   verion of TWASSIST.
  804.  
  805.     Feel free to hack and rip into the macro as you see fit.
  806.  
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.                                    Page 14
  840.  
  841.  
  842. ╔════════════════════════════════════════════════════════════════════════════╗
  843. ║ Section  7                       Telemate                                  ║
  844. ╚════════════════════════════════════════════════════════════════════════════╝
  845.  
  846.   File:  TWASSIST.TLM   (source code)
  847.  
  848.          (NOTE:  The file was originally named TWASSIST.SCR.  This caused a
  849.                  conflict with the name already used by the Qmodem script.
  850.                  I renamed the file to TWASSIST.TLM to put in the archive.
  851.                  You should rename it back to TWASSIST.SCR after you retrieve
  852.                  it from the archive.
  853.                                               -- Albin)
  854.   File:  TWASSIST.TMS   (compiled code)
  855.     By:  Francis Ng
  856.   Date:  03/28/95
  857.  
  858.  
  859. *  denotes new information for the 03/28/95 update
  860.  
  861.   This script makes gathering the various reports that TWAssist can use
  862.   easy.  Just turn on a capture file, run the script, and make a menu
  863.   selection.  In addition, the script will act as the interface between the
  864.   new TWASSIST mapping routines and Telemate, allowing you to learn about
  865.   most of the warps in a universe without using a turn.
  866.  
  867. * These scripts have been updated to work properly with the 
  868.   the v2 betas. v1.03 is no longer supported.  Changes include:
  869.     -The ability to run TWASSIST from a directory other than 
  870.      Telemate.  
  871.     -Gathering of both limpet and normal mines reports.
  872.     -The scripts will now keep track of what TWASSIST data file 
  873.      prefixes you use depending on what BBS you are connected to 
  874.      and automatically pass the data file prefixes on to TWASSIST.
  875.      This information is stored in a file called TWTM.BBS 
  876.      which will created in your Telemate directory.
  877.     -When capturing reports, the scripts will automatically 
  878.      create a log file called CAPTURE.TXT in your TWASSIST directory.
  879.  
  880.   INSTALLATION
  881.  
  882.   Before you can use the script, you need to put everything in place.  If
  883.   you have a script directory for Telemate, put this script there.  If not,
  884.   Telemate will look in the same directory as telemate itself.  I like
  885.   having a seperate directory for scripts, but it isn't necessary.  You
  886.   also need TOOLBOX1.SCR and TOOLBOX2.SCR available in that same directory.
  887.   These come with Telemate.  The TWASSIST.SCR file has a #include line for
  888.   each of these which includes a path name.  You will need to edit that
  889.   path name to make sure it points to the right directory.
  890.  
  891. * You will also need to enter a directory path to your 
  892.   TWAssist executables.  Please see TWASSIST.TLM.
  893.   If you haven't already done so, you must define your 
  894.   Telemate directory in the TM directory setup.  It can be 
  895.   reached by pressing Alt-O then I from the menu bar.
  896.  
  897.  
  898.  
  899.                                    Page 15
  900.  
  901.  
  902.                             7  Telemate  (cont'd)
  903.  
  904.  
  905.   Telemate also comes with a program called TMS.EXE.  It compiles scripts,
  906.   such as TWASSIST.SCR into the codes that Telemate uses.  The first time
  907.   you try to run TWASSIST.SCR Telemate will use TMS.EXE to compile the
  908.   script, creating TWASSIST.TMS.
  909.  
  910.   The "Map the Universe" part of the script will call TWAssist as it runs.
  911.  
  912.   I am not a Telemate user.  I wrote these to help out TW players who use
  913.   Telemate because Albin had mentioned that many people had asked for
  914.   scripts to support Telemate such as the ones available for Telix and
  915.   other comm programs.  Since I'm not a Telemate user and learned the
  916.   script language just for this script, there are probably improvements
  917.   that can be made.  If you make any improvements, please consider sending
  918.   them to Albin, so he can consider distributing them with future versions
  919.   of TWAssist.
  920.  
  921.  
  922.   With everything in place as described, you can start the script by
  923.   pressing Alt-S and selecting TWASSIST.SCR (or TWASSIST.TMS once it's been
  924.   created.)  But an easier way would be to create a macro tied to a key so
  925.   that a single key-press would start the script.  To do this, first run
  926.   Telemate.  In Telemate, press Alt-M.  That will pop up a macro screen.
  927.   Pressing Alt-M again will give you a menu.  You can tie the script to
  928.   whichever key you want - I'll give directions for Alt-F1.  On the
  929.   macro-menu, one of the choices is A)lt keys.  Press A, and a box will
  930.   appear showing what the macros for the various Alt keys are.  Select the
  931.   Alt-F1 line.  Enter "^\TWASSIST.SCR" (with no quotes).  Save the changes
  932.   and exit out.  Now pressing Alt-F1 should run the script.
  933.  
  934.  
  935.   USING THE SCRIPT
  936.  
  937.   When you run the script (after pressing Alt-S and selecting it, or after
  938.   using your hot-key) you will get a menu which looks similar to this.
  939.  
  940.                ╔══════════════════════════════╗
  941.                ║                              ║
  942.                ║ (T)W2002 Assistant           ║
  943.                ║                              ║
  944.                ║ (A)ll reports                ║
  945.                ║                              ║
  946.                ║ (C)IM warp and port reports  ║
  947.                ║ (P)ort report                ║
  948.                ║ (F)ighters, mines and avoids ║
  949.                ║                              ║
  950.                ║ (M)ap the Universe           ║
  951.                ║                              ║
  952.                ║ (E)xit script                ║
  953.                ║                              ║
  954.                ║ Your Selection?              ║
  955.                ║                              ║
  956.                ╚══════════════════════════════╝
  957.  
  958.  
  959.                                    Page 16
  960.  
  961.  
  962.                             7  Telemate  (cont'd)
  963.  
  964.  
  965.   You can run TWAssist, gather reports (either all, or just some, depending
  966.   on your need,) or do mapping.  Just make a selection.
  967.  
  968.   Most of the choices don't need much explanation.
  969. * If you choose to capture reports, the scripts will open a capture
  970.   file called "CAPTURE.TXT" in the TWAssist directory.  ANSI will
  971.   be turned off when gathering reports or mapping - and it will be
  972.   restored after the scripts have run depending on if ANSI was on
  973.   or not before the script was started.  By default, the scripts
  974.   will turn off the Animation setting inside TW.
  975.  
  976.   I will explain the Mapping choice a bit though.
  977.  
  978.   When you use mapping script, it will be turning a capture file on and
  979.   off, and deleting the file from time to time.  If a capture file is open
  980.   when you start mapping, that file will be closed.  It will not be opened
  981.   again when the script ends.
  982.  
  983.   When you choose mapping, the script will ask you for a filename.  Don't
  984.   give an extension.  The filename is the name you use for that game in
  985.   TWAssist.  For example, I did my testing on Reynard's Keep BBS.  I used
  986.   the name REYNARDS for it.  If I was playing on The Chess Board BBS, I
  987.   might use CHESSBRD.
  988.  
  989. * The mapping procedure will use a TWTM.BBS entry if it is 
  990.   available.  
  991.  
  992.   If you have not used TWAssist with that filename, the .DAT file won't
  993.   exist.  In that case the script will warn you, and ask if you want to
  994.   continue.  If you mistyped the filename, say no.  If this is the correct
  995.   filename, and you haven't run TWAssist for that game yet, say Yes to
  996.   continue.
  997.  
  998.   The script will also ask how many warps to plot.  It will give a default,
  999.   which is recommended.  The default varies with your baud-rate.
  1000.  
  1001.   After the script has done one group of warps, you will be asked if you
  1002.   want to continue.  The amount of time left should affect your choice.
  1003.  
  1004.  
  1005. * ADDITIONAL INFORMATION
  1006.  
  1007.   The following applies only if you have connected to a BBS 
  1008.   using Telemate's dialing directory.  
  1009.  
  1010.   The scripts will store TWAssist data file prefixes 
  1011.   along with their corresonding Telemate BBS Dialing Directory 
  1012.   Entries in a file (TWTM.BBS) which will automatically be 
  1013.   created the first time you try to run TWAssist from the 
  1014.   script menu.          
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                                    Page 17
  1020.  
  1021.  
  1022.                             7  Telemate  (cont'd)
  1023.  
  1024.  
  1025.   If no TWAssist data file entry is found in TWTM.BBS, you will
  1026.   be prompted to enter one.  This data file entry should be relative 
  1027.   to your TWAssist directory.  If you just enter a name 
  1028.   (such as hawknest), the corresponding TWAssist data files 
  1029.   will be located in your TWAssist directory.  You may also
  1030.   enter directories.  If you wish to store all your Hawk's Nest
  1031.   TWAssist data files in a directory called hawknest, you can
  1032.   enter hawknest\hawknest.  Note that in order to use a
  1033.   directory,  the directory must exist prior to you running 
  1034.   the script (ie. the hawknet\ directory must already exist).
  1035.   After entering the new database file you will be asked if you
  1036.   would like the database file written to TWTM.BBS.  You would
  1037.   normally chose yes.
  1038.  
  1039.   If you have not connected using the TM dialing directory, 
  1040.   each time you run TWAssist from the script menu, you will have 
  1041.   to manually enter the data file name.                    
  1042.  
  1043.   
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.  
  1069.  
  1070.  
  1071.  
  1072.  
  1073.  
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079.                                    Page 18
  1080.  
  1081.  
  1082. ╔════════════════════════════════════════════════════════════════════════════╗
  1083. ║ Section  8               Procomm Plus for Windows                          ║
  1084. ╚════════════════════════════════════════════════════════════════════════════╝
  1085.  
  1086.   File:  TWCAP.WAS
  1087.   File:  TWMAP.WAS
  1088.     By:  Neil Catone
  1089.   Date:  08/22/94   v1.20  Updated for Trade Wars 2002 v2 beta
  1090.  
  1091.   (Neil did not submit anything for this doc.  I am extracting a few things
  1092.    from the comments in the files and looked for some special places to be
  1093.    noted.  I suggest you read through the comments in the files before using
  1094.    them.  -- Albin)
  1095.  
  1096.     These scripts were developed with Procomm Plus for Windows.  The scripts
  1097.   were written and tested with ProComm Plus for Windows v1.01.
  1098.  
  1099.     To compile the scripts (make them useable), edit them the way you want,
  1100.   (the comments that begin with a ';' are okay to leave in -- they don't
  1101.   affect the file in any way) copy them into your \PROWIN\ASPECT\ directory,
  1102.   and COMPILE AND RUN.  The scripts may be assigned to a Meta-key for ease
  1103.   of use.
  1104.  
  1105.   From TWCAP.WAS:
  1106.  
  1107.   ATTENTION!  This file will get your deployed fighters, deployed mines,
  1108.   the game status (V), your avoids and also gets you into the C.I.M. to
  1109.   get your port & warp info.  It will automaticaly log all of this to the
  1110.   C:\PROWIN\TW\ directory as the file 'TW.CAP', then return the default
  1111.   capture path to C:\PROWIN\CAPTURE\.  You may need to change this
  1112.   information to reflect your directory configuration.
  1113.  
  1114.   NOTE that this script will delete your last 'TW.CAP' if it exists to
  1115.   keep your data files from getting overgrown.
  1116.  
  1117.   (I noticed one place in TWCAP.WAS where you need to edit in a sector number
  1118.    that has a port. -- Albin)
  1119.  
  1120.   From TWMAP.WAS:
  1121.  
  1122.   ATTENTION!  This file will get route info from the Trade Wars
  1123.   computer C.I.M. mode.  It will automaticaly log all of this to the
  1124.   C:\PROWIN\TW\ directory as the file 'MAP.CAP', then return the default
  1125.   capture path to C:\PROWIN\CAPTURE\.  You may need to change this
  1126.   information to reflect your directory configuration.
  1127.  
  1128.   NOTE that this script will delete your last 'MAP.CAP' if it exists to
  1129.   keep your data files from getting overgrown.
  1130.  
  1131.   Prior to running this macro, you must create the "game.CIM" file
  1132.   from TWASSIST.  Under the <R>oute Reports menu, select <M>ap universe
  1133.   routes and follow the instructions.  The more the route commands, the
  1134.   longer it will take online, depending on baud rate.  Reference
  1135.   TWASSIST.DOC for more information on mapping universe routes.
  1136.  
  1137.  
  1138.  
  1139.                                    Page 19
  1140.